home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / printing / quiklabl.arc / QUIKLABL.DOC < prev    next >
Text File  |  1989-06-10  |  7KB  |  161 lines
  1.  
  2. Documentation for Quick Label 1.0 
  3. =================================
  4.  
  5. (C) 1989 by Ignac A. Kolenko 
  6.  
  7.  
  8. Quick Label runs on any ST, color or mono, with TOS in ROM.
  9. (medium resolution recommended due to dialog box sizes!)
  10.  
  11. To use Quick Label, double click on the file QUIKLABL.PRG. A 
  12. dialog box will appear, and the screen colors will change to 
  13. white, black, red and green (on a color monitor only!). 
  14.  
  15. A set of 10 button, labelled from 0 to 9 are the label editing
  16. buffers. This program allows you to edit 10 labels simultaneously,
  17. which is a great asset for the times you need more than one set of
  18. labels done at one time. To choose a label buffer, simply click
  19. on one of the numbered buttons.
  20.  
  21. Once a buffer has been selected, you can Edit that buffer, or
  22. Load a previously edited label into that buffer. Click either Edit
  23. or Load to perform these function. Editing is described later in
  24. this documentation file. 
  25.  
  26. Also, once a buffer has been selected, you can Save that label (the
  27. standard extender used for labels generated by Quick Label is .LAB)
  28. or clear the label (empty its contents). Clich either Save or Clear
  29. to perform these functions.
  30.  
  31. The final option you have with the currently selected label is to
  32. print it. If you do not load a configuration file, the text will
  33. come out as normal, plain vanilla text (ie: no fancy formatting will
  34. be performed.) So naturally, you will want to load a configuration
  35. file. The configuration file supplied with this program is EPSON.CNF.  
  36. You can double click on this, or  any other properly constructed .CNF file. 
  37. I will discuss how to set up your own .CNF file later in the documentation.
  38. If you choose not to load a configuration file, all printer commands 
  39. will be ignored.
  40.  
  41. Editing is very easy. Clicking on 'Edit' will display a very large
  42. dialog box (the reason this program will not work  as well in low 
  43. resolution is that this box will be chopped off at the sides).  
  44. There are ten lines of forty characters each  for  label 
  45. text, which is plenty for most standard sized labels.  
  46.   
  47. Also, there are three editable fields at the bottom of the screen 
  48. which allow the number of labels, the number of text lines per 
  49. label and the width of the label to be set. Note that the printing 
  50. routines will check the value of the label width field and if it 
  51. is set to zero, that label will not be printed. That is an easy 
  52. way  to pick and choose which labels you don't want printed later 
  53. on.
  54.   
  55. The most obvious feature of this dialog box is the table of control codes
  56. on the right side of the dialog box. This table shows the the control 
  57. character, the graphic symbol the Atari ST displays on the screen after 
  58. the control character is pressed, and the corresponding printer command
  59. it issues. Thus, if you want to make the third line of the label compressed, 
  60. simply cursor down or up to the third line, press <Control>C  
  61. (a right arrow will appear), type in your text, and press <Control>N 
  62. to return to normal print (the left half of the Atari symbol  will  appear). 
  63. Thus, when the label is printed, the third line will be output in 
  64. the printer's compressed mode. It is just as easy to use any of 
  65. the printer's control codes in the same manner as above. Load in EXAMPLE.LAB
  66. supplied in the arc'ed file to see most of the control codes in action.
  67.   
  68. When ready to print a label, simply go and click on 'Print One'. This will 
  69. output the specified number of labels with the specified number of lines per 
  70. label as typed in the edit dialog. If you wish to output all the labels 
  71. in memory at once, just click on 'Print All' under Label. As stated above,  
  72. a label with  the  label  width set to zero will  not  be  printed,  which 
  73. insures that if you only have two labels in  memory, only two 
  74. labels will be printed, since the rest of the labels are  zeroed 
  75. out.  
  76.  
  77. To clear out a label so that another may be started from  scratch, 
  78. just click on 'Clear' under Label. The three numerical fields will 
  79. be reset to zero, and the label text will be reset to null. You do 
  80. not need to do this if you are loading a label, since loading will 
  81. obliterate what was there automatically.
  82.  
  83.  
  84. HOW TO CREATE YOUR OWN CONFIGURATION FILE
  85. -----------------------------------------            
  86.  
  87. It is easiest to study a few lines from the EPSON.CNF file supplied with 
  88. this program to help create your own  configuration file. The first two 
  89. lines appear as such:
  90.  
  91. 27,69;          A       Emphasized print on
  92. 27,70;          B       Emphasized print off
  93.  
  94. The numbers on the left of each line are the printer control codes. For 
  95. instance, to turn emphasized print on on an Epson printer, you need to 
  96. send it an escape 'E' sequence. By checking the ASCII codes for escape and 
  97. 'E' (published in almost all computer books and manuals), we see that escape 
  98. is 27 and 'E' is 69. Each separate control code must be separated by a 
  99. comma, and when the control sequence is done, a semicolon must be present if 
  100. you wish to make comments on the same line. 
  101.  
  102. Still with the example above, after the semicolon, I have typed the letter 
  103. 'A'. This is just a reminder to everyone that the first line corresponds 
  104. to <control>A in the label edit menu choice (you can check there if you 
  105. want to verify). Finally, I typed  in  a description  of  what these 
  106. codes do for each control sequence, allowing you to easily locate the 
  107. code sequences you want to change.
  108.  
  109. A few other words of warning about this file: firstly, there must be no 
  110. carriage returns before the first line, since the program will read in only
  111. the first twenty-six lines of the configuration file. Any additional
  112. comments may  be placed after the last control sequence, starting on line 27
  113. of the configuration file, like I have. Also, only five control codes per 
  114. line are allowed. Finally, configuration files from other programs 
  115. will not work with this one,  since most are printer drivers.
  116.  
  117. Pay for shareware and receive updates!
  118. --------------------------------------
  119.  
  120. At this time, we would like to receive some user feedback before we go
  121. ahead and implement any new features. What else you you like to see in this
  122. "super label editor"?
  123.  
  124. As a registered user of this program, you will receive the rest of the 
  125. Quick family of quality shareware:
  126.  
  127. Quick Find  - fast file finder
  128. Quick Inf   - desktop information editor
  129. Quick View  - fast text viewer
  130. Quick Print - text only screen dumper (significantly faster 
  131.               than graphics dump)
  132. Quick Index - the de-facto benchmark for the Atari ST
  133. Quick ST    - fast VT52 and GEM speedups
  134.  
  135. To become a registered user, send a $30 (if you wish only to receive
  136. Quick ST, send $20) check or money order to:
  137.  
  138.     Darek Mihocka
  139.     Box 2624, Station B
  140.     Kitchener, Ontario  N2H 6N2
  141.     Canada
  142.  
  143. You can reach us by modem on the following networks:
  144.  
  145. Ignac Kolenko:
  146.     Usenet: watmath!watcgl!electro!ignac
  147.  
  148. Darek Mihocka:
  149.     Compuserve: 73657,2714
  150.     BIX, Delphi, GEnie: DAREKM
  151.  
  152. both:
  153.     Usenet: watmath!watcgl!oaee455s
  154.  
  155. We thank you for supporting shareware and encourage you to support other
  156. shareware authors. You may distribute copies of Quick Label
  157. under the condition that you also include this documentation file. You may
  158. not charge a fee or in any way try to sell this software.
  159.  
  160.  
  161.